home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / BARNET / FREENET / LAWTON / ICHATV06 / !iChat / !Help next >
Text File  |  1998-12-19  |  9KB  |  233 lines
  1. Name    : !iChat
  2. Purpose : IRC Client for RISC OS
  3. Author  : © T.Lawton/ARMageddon Systems 1997
  4. Version : 0.69
  5.  
  6. Introduction
  7. ~~~~~~~~~~~~
  8.     This was written partly as a programming exercise and partly because
  9. I just was so fed up with IRClient crashing. I'm hoping it will become a good
  10. IRC client, not as powerful or configurable as IRClient but hopefully more
  11. aesthetically pleasing and usable.
  12.  
  13.     This is now much more of a complete program. However, if you spy any
  14. bits missing (I can see a few myself), then don't hesitate to write and ask
  15. for alterations.
  16.  
  17.     A 4-step history has been added. Use the up-arrow to recall
  18. previously typed text (recalls from all windows, not just the current one).
  19.  
  20.     Full DCC chat support has now been added. Use "/CHAT <nick>" to start
  21. up a DCC chat session. Full DCC send support exists also, either using the
  22. old "/CTCP <nick> DCC SEND <file>" or by dragging a file into a window. iChat
  23. will also make a guess as to whom you wish to send the file - the currently
  24. selected nick in a channel, or the person you're talking to if you drag to a
  25. private window.
  26.  
  27.     This client is mIRC compatible in that it displays colours,
  28. underlines, bold and italics correctly. You can now see channels as vibrant
  29. as they should be, and as most PC users see them. Now, using ^C, ^I, ^B and
  30. ^L, you can produce colours yourself.
  31.  
  32.     Lists of servers have now been added. If you don't want to use them -
  33. just carry on as normal. Otherwise, you can use the menu buttons to bring up
  34. a list of servers in different categories. Editing the "Servers" file is not
  35. recommended; but if you want to then use:
  36.  
  37. *<network> - network name, followed by
  38. <server>,<ports> - where the ports are either a number "6667" or a range
  39.            "6667-6669"
  40.            use a colon to separate ranges where there is no
  41.            continuity (eg 6665-6669:7000)
  42.            
  43.     Macros are a new addition. The format is the same as a messages file
  44. for anyone that uses them - have a look and it should be reasonably obvious.
  45. The %0 to %3 are replaced by the parameters passed by the macro. Macros can
  46. call other macros, to perform more complex actions - and by separating
  47. commands by "|M", multiple commands can be called by one macro.
  48.  
  49.     Warning: be careful not to let a macro call itself - as this will
  50. cause an infinite loop and crash iChat. This may not be direct, eg if a macro
  51. calls a macro that then calls the first one etc. To use a macro, simply use
  52. it as a normal command - eg "/hug Cliche" will use the 'hug' macro (if one is
  53. defined) with %0 being "Cliche". Obviously, if a macro is defined that has
  54. the same name as an iChat command, it will never be activated as the iChat
  55. command takes priority.
  56.  
  57.     This new version is no longer a step backwards. DCC file support
  58. exists for both sending and receiving. The delay in full support is due to
  59. iChat having a total rewrite, from scratch. Not a single piece of code has
  60. survived my onslaught. v0.55 was getting to be patched and badly put
  61. together, and made a lot of invalid assumptions. This version is much better
  62. written, and due its now supporting everything v0.55 did, and more, v0.55 has
  63. now been officially discontinued.
  64.  
  65.     This version supports WimpCTCP. If you download WimpCTCP applications
  66. from the freenet site (so far, all are by Justin Fletcher) they will
  67. integrate with iChat and allow extra functions. Help for WimpCTCP
  68. applications is contained within the applications themselves.
  69.  
  70.     Where both iChat and a WimpCTCP program both support the same
  71. command (currently this is only DCC send), the WimpCTCP program will be used
  72. only if it has been loaded - otherwise iChat's routines will be used. Where
  73. there is no duplication of function, WimpCTCP programs will be loaded
  74. (providing they have been "seen" by the filer) as necessary.
  75.  
  76.     There have been some problems with using WimpCTCP to send files as
  77. Justin's routines can't always work out your hostname. The quick fix for this
  78. is to put the following line in the !DCC run file - make sure it is just
  79. after the line that says "Run <DCC$Dir>.Hostname"
  80.  
  81.  Set DCC$Hostname <whatever your hostname is>
  82.  
  83.     As iChat now supports DCC natively, this should hopefully no longer
  84. be necessary - but remember that if you want to use !DCC instead of iChat's
  85. own routines then you simply need to have it loaded.
  86.  
  87.  
  88. Latest Version
  89. ~~~~~~~~~~~~~~
  90.     The latest version is always available from the freenet site:
  91.        freenet.barnet.ac.uk in pub/Acorn/freenet/t.lawton
  92.     or my own site:
  93.        www.klmc.demon.co.uk
  94.  
  95. Use
  96. ~~~
  97.     Connect to the internet in the normal way. Click on the iChat icon to
  98. open the 'Connect' window. The settings should be altered to show your nick and
  99. other details. If you know of an irc server, you can enter its details or use
  100. the server already entered. Click on 'Save' to save the settings, then
  101. 'Connect' to connect to the server. There will be a short delay while iChat
  102. locates the server, then the main window will open. Happy IRCing...
  103.  
  104.     While connected, a 'select' click on the icon bar opens the main server
  105. window, and from there you can select channels to open.
  106.  
  107.     On a channel, the list of users can be perused by clicking on the up and
  108. down arrows. If you select a nick by clicking on it, you can then click on one
  109. of the command buttons to perform that action. eg to ping 'Cliche', select the
  110. nick and click on the 'ping' button. This can also happen in the server window
  111. by selecting a channel and clicking to leave, for example. Double clicking on a
  112. nick is the same as 'Query' - it opens a private chat window so you can talk to
  113. that person without being 'overheard'. For a truly private (and fast) chat,
  114. 'DCC' allows direct communication. Just type '/CHAT <nick>' or select the
  115. nickname and click on the 'Chat' button.
  116.  
  117.     Colours can be added by using ^C (control-C), then typing numbers.
  118. ^Cn sets the foreground to colour n (use the range 0-15), ^Cn,m (ie
  119. control-c, then a number, then another number) sets foreground to n and
  120. background to m. A colour control code appears in the text input icon as a ©
  121. character. ^C on its own resets to default colours.
  122.  
  123.     ^I (appears as ¬), ^B (appears as ¤) and ^L (appears as …) toggle
  124. italics, bold and underline. Experiment to see them in action. The only
  125. drawback of this system is if you actually want to use ©,¬,¤ or … they will
  126. be interpreted by iChat as typesetting commands. However, as these are
  127. high-ascii characters you shouldn't use them anyway as they will appear
  128. different on a PC.
  129.  
  130.     To send a file, simply drag it to an iChat window and then tell iChat
  131. the nickname of the person you want to send it to. Receiving files is very
  132. similar to saving from any normal RiscOS application.
  133.  
  134.  
  135. Colours
  136. ~~~~~~~
  137.  0 white
  138.  1 black
  139.  2 blue  
  140.  3 green
  141.  4 red
  142.  5 brown
  143.  6 purple
  144.  7 orange
  145.  8 yellow
  146.  9 lt.green
  147.  10 teal
  148.  11 lt.cyan 
  149.  12 lt.blue
  150.  13 pink
  151.  14 grey
  152.  15 lt.grey
  153.  
  154.  
  155. Commands
  156. ~~~~~~~~
  157.  
  158. /PING <nick>          - Pings the person
  159. /ME <text>           - for actions eg '/me smiles'
  160. /JOIN <channel>      - join the channel
  161. /PART <channel>      - leave the channel
  162. /LEAVE <channel>     - leave the channel
  163. /QUIT <message>      - disconnect from IRC, and leave a message
  164. /MSG <nick> <text>    - send a private message to someone
  165. /NICK <new nick>    - change your nickname
  166. /QUERY <nick>        - opens a window to talk to someone privately
  167. /CHAT <nick>        - DCC chat to someone
  168. /WHOIS <nick>        - gives information about someone
  169. /KICK <nick>        - kick someone from the current channel
  170. /KICK <channel> <user>    - kick someone from a specified channel
  171. /LIST <specifier>    - lists channels matching specifier
  172. /FINGER <nick>        - gives some information about the user
  173. /CTCP <nick> <command>    - transmits a CTCP command to someone (use for WimpCTCP)
  174. /MODE <channel> <mode>    - change the mode of a nick or channel
  175. /UMODE <mode>        - change your mode
  176. /NAMES <channel>    - find out who's on a channel
  177. /TOPIC <channel> <topic>- set the topic of a channel
  178. /QUOTE            _ send text direct to the server (if you know what
  179. /RAW              you're doing
  180. /LOG            - turns logging on or off
  181.  
  182.  
  183. To add
  184. ~~~~~~
  185.     recode user handling in assembler
  186.     configurable fonts
  187.     cosmetic changes to "whois"
  188.     Notify list to tell you when friends join
  189.     more complicated scripting
  190.     url hilighting
  191.     
  192.  
  193. Legal Bits
  194. ~~~~~~~~~~
  195.     iChat is 'RegisterWare'. It's totally free to use, so long as you
  196. simply send me a message to tell me you're using it. The copyright remains
  197. mine at all times but feel free to distribute it so long as all files are in
  198. their original state and all files are included.
  199.  
  200.     If anyone needs the source code, for any reason, just write to me and
  201. I'll consider it. If it's just to add/change something I'd generally prefer
  202. to make the changes available to everyone.
  203.     
  204.     The author, and ARMageddon Systems, do not accept responsibility for
  205. any damage or loss caused by iChat.
  206.  
  207.  
  208.      Send ideas/registrations to:
  209.       tlawton@docnet.org.uk
  210.       
  211.      I would also be grateful for any ideas/bug reports/anything else..
  212.  
  213.  
  214. Thanks to
  215. ~~~~~~~~~
  216.  
  217. All of #coolbreeze on DALnet - for being the friendliest channel on the net
  218.  
  219. Certain members of #acorn - for providing "constructive" criticism :>
  220.  
  221. Jonathan Potts - for being stressed
  222.  
  223. Peter Wightman - for keeping me up-to-date on the world's non-events
  224.  
  225. Nick De Pennington - for being a complete rowing god
  226.  
  227. Nick London - for being a wonderful coach
  228.  
  229. Joern-Erik Burkert - for the icon, and lots of advice
  230.  
  231. Justin Fletcher - for WimpCTCP
  232.  
  233.